home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 126-150 / disk_134 / smarticon / si.doc.eng < prev    next >
Text File  |  1992-05-06  |  8KB  |  215 lines
  1.  
  2.    SmartIcon 1.0  - A task-transparent Intuition objects iconifier.
  3.    -------------
  4.  
  5.    Copyright © 1988 Gauthier H. Groult
  6.    Written by Gauthier H. Groult in January 1988
  7.  
  8.    Postal address:      Gauthier H. Groult
  9.                         33, Boulevard Saint Denis
  10.                         92400 Courbevoie, France, Europe
  11.    Email:               seismo!mcvax!inria!geocub!itecom!groult
  12.  
  13.    Permission is hereby granted to anyone to distribute this software
  14.    FOR NON COMMERCIAL PURPOSES ONLY, and as long as the two text files
  15.    comming with the binary are kept with it.
  16.  
  17.    This program is a SHAREWARE program. Please read the "Registration"
  18.    section BEFORE installing the program in your startup!
  19.  
  20.  
  21.  
  22.    SCOPE OF THIS FILE
  23.    ------------------
  24.  
  25.    This file is divided in x sections:
  26.  
  27.             1. Features and installation
  28.             2. Bugs
  29.             3. Registration
  30.             4. Updates preview
  31.  
  32.  
  33.  
  34.    1. FEATURES AND INSTALLATION
  35.    ----------------------------
  36.  
  37.    SmartIcon 1.0 is an Intuition objects iconifier. Version 1.0 is
  38.    limited to windows.
  39.    The main feature of this program is to add a gadget to an Intuition
  40.    window and let you iconify the window by just selecting that gadget.
  41.    The icon produced for the window is a true Workbench file icon,
  42.    created in the Ram Disk directory. Thus it has the original
  43.    qualities of Workbench icons, but also the drawbacks.
  44.    SmartIcon is transparent: the program running on the iconified
  45.    window doesn't even notice that his window is not on the display
  46.    anymore. This is because (almost) all the resources attached to
  47.    the window remain opened and available to the task while the window
  48.    is iconified.
  49.    SmartIcon lets you iconify windows supporting heavy graphics like
  50.    the Box or Dots demos windows.
  51.  
  52.    To install the program, just double-click on its icon then click in
  53.    the window.
  54.    All the opened windows with depth gadgets will then be patched, on
  55.    all screens. All future windows will also be patched (try opening a
  56.    Workbench drawer).
  57.    To iconify the window, just click on the new "system" gadget, and
  58.    an icon will be created in the ram disk while the window is hidden.
  59.    Double click on this icon and your window will come back, while the
  60.    icon will be removed!
  61.  
  62.    SmartIcon can be started from the Workbench or CLI. If started from
  63.    the CLI, it support one argument:
  64.  
  65.          SmartIcon -f
  66.  
  67.    will install the program without displaying the startup window. This
  68.    is convenient for installing the program in your startup-sequence
  69.    once you have registered...
  70.  
  71.    Once installed, SmartIcon can be removed by a CTRL_C or a BREAK C.
  72.    This means that you cannot actually remove it when it is launched
  73.    from the Workbench.
  74.    You can kill SmartIcon even if some of your windows are still
  75.    iconified, you will still be able to re-open them.
  76.  
  77.    SmartIcon works fine in conjunction with DropCloth and DropShadow.
  78.  
  79.    For developpement purposes: your task will receive a GADGETUP
  80.    message with a code value of 11366 when its window is iconified.
  81.  
  82.    What you should NOT do:
  83.    -----------------------
  84.  
  85.       1. Do not iconify the Ram Disk drawer window: you wouldn't be
  86.          able to acces the icons it contains anymore, and the files
  87.          do not run from the CLI!
  88.  
  89.       2. Do not discard (trash) an iconified window's icon: you would
  90.          loose the possibility to reveal the window.
  91.  
  92.  
  93.  
  94.    2. Bugs
  95.    -------
  96.  
  97.    Revision 1.0 of SmartIcon as some undesirable features which may be
  98.    considerated as bugs.
  99.  
  100.    The first problem is a system bug: the Workbench does not update the
  101.    icon display when a file is removed or added unless you close and
  102.    re-open the drawer/disk window. This is why you do not see the
  103.    window icon when you just iconify it and when the Ram Disk window is
  104.    opened. This is also the reason why the window icon will pertain in
  105.    the opened Ram Disk window or on the Workbench window when you
  106.    reveal a window.
  107.  
  108.    SmartIcon iconifies only window with depth gadgets. It will have no
  109.    effects on windows with no depth gadgets like DropCloth's window.
  110.  
  111.    The Ram Disk window can be iconified: doing this is a dire strait.
  112.  
  113.    Some windows with depth gadgets will not be patched correctly. This
  114.    is the case, for instance, of the System Request windows (sight!).
  115.    The reason why it doesn't work is not known to me yet. It is likely
  116.    that these windows are not opened trough a normal Intuition library
  117.    call, but rather trough a direct jump at an absolute address.
  118.  
  119.    A few windows will crash the system when iconified. They are very
  120.    rare, and the reason is still unknown. A good example is the NewZap
  121.    window.
  122.    Trying to iconify programs being real wild on Intuition or Layers
  123.    lists can cause SmartIcon or the system to crash. Altough I know
  124.    this is possible, I haven't found any case of this yet. It seems
  125.    that most of the Amiga software is clean, which is great.
  126.  
  127.    The program does not currently test for existing files in the ram
  128.    disk. Thus windows with unappropriate names may trash ram disk
  129.    files. This is unlikely, tough.
  130.  
  131.    A small bug will trash the icon gadget when a window is made very
  132.    small and when the title is longer than the title bar. This is only
  133.    a display bug, it as no effect on the program. It is corrected when
  134.    the window is enlarged again.
  135.  
  136.  
  137.  
  138.    3. REGISTRATION
  139.    ---------------
  140.  
  141.    SmartIcon is NOT a freeware program. It is SHAREWARE, and priced at
  142.    $15 to $20 or 100 to 120 French Francs (or anything more!).
  143.    If you intend to USE it or KEEP this program, please send your
  144.    registration fare at the postal address mentioned on top of this
  145.    file.
  146.  
  147.    By doing so, you will:
  148.  
  149.       1. Gain access to the program sources and technical information.
  150.          The detailed and clearly commented source files cover topics
  151.          such as:
  152.                a) Intuition list browsing
  153.                b) Layers
  154.                c) Intuition and Exec libraries traps
  155.                d) Icon library
  156.                e) Workbench and CLI arguments
  157.                f) Coding binary files in C
  158.                g) Lists management
  159.                and more...
  160.          All sources are for Lattice C compiler and MC68000 assembler.
  161.          The sources will be mailed to you IMMEDIATLY upon receival of
  162.          your registration.
  163.  
  164.       2. Register for free futures updates of SmartIcon. Read the next
  165.          section for a description of expedted updates.
  166.  
  167.       3. Support developpement of (good) software for the Amiga.
  168.  
  169.       4. Let next similar programs be freeware.
  170.  
  171.    You might think that the fare is more expensive than for usual
  172.    equivalent shareware programs: please note that the user support
  173.    will in most cases include at least two overseas mailings.
  174.  
  175.  
  176.  
  177.    4. UPDATES PREVIEW
  178.    ------------------
  179.  
  180.    I intend to add many features to the next revisions of SmartIcon.
  181.    Revision 2.0 will include:
  182.  
  183.       1. Bug fix for the windows not being patched in 1.0 (I WANT to
  184.          be abble to iconify those Sofware Failures!!), plus various
  185.          other bug fixes.
  186.  
  187.       2. User selectable option to force depth gadgets on windows that
  188.          open without (I WANT to be abble to iconify that DropCloth!!).
  189.  
  190.       3. Support for Intuition Screens iconification.
  191.  
  192.       4. Support for a user supplied path for the window icons and
  193.          screen icons directories.
  194.  
  195.       5. User selectable lenght for the window icons names.
  196.  
  197.       6. Maybe some code to force Workbench update if this is made
  198.          possible under 1.3 (can you read me, Dale?).
  199.  
  200.       7. Smaller and faster code.
  201.  
  202.       8. Better memory usage.
  203.  
  204.       9. Nice user interface.
  205.  
  206.  
  207. All suggestions, comments, donations are welcome. Please feel free to
  208. write me!
  209.  
  210. Special thanks to every single programmer who placed its software in
  211. public domain. I feel that what has been done and what is going on
  212. with public domain on the Amiga is just wonderful. Moreover, it has
  213. been very helpful to me.
  214.  
  215.